SPECIFICATION 



TO ALL WHOM IT MAY CONCERN: 

Be it known that we, Mark Lucovsky and Steven D. White, have invented a certain 
new and useful SCHEMA-BASED SERVICES FOR IDENTITY-BASED ACCESS TO 
CONTACTS DATA of which the following is a specification. 



SCHEMA-BASED SERVICES FOR IDENTITY-BASED ACCESS 

TO CONTACTS DATA 



CROSS REFERENCE TO RELATED APPLICATIONS 

5 The present application claims priority from co-pending United States provisional 
application serial number 60/275,809, filed March 14, 2001 and entitled "Identity-Based 
Service Communication Using XML Messaging Interfaces", which is hereby incorporated 
herein by reference in its entirety. The present application is related to United States Patent 
Application serial number entitled Schema-Based Services for Identity-Based Data 

10 Access, filed concurrently herewith on October 22, 2001 . 

COPYRIGHT DISCLAIMER 

A portion of the disclosure of this patent document contains material that is subject to 
copyright protection. The copyright owner has no objection to the facsimile reproduction by 
15 anyone of the patent document or the patent disclosure as it appears in the Patent and 

Trademark Office patent file or records, but otherwise reserves all copyright rights whatsoever. 

FIELD OF THE INVENTION 

The invention relates generally to computer network data access, and more particularly 
20 to systems, methods and data structures for accessing data and data-related services over a 
network. 
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BACKGROUND OF THE INVENTION 

There are many types of data that users need to manage and otherwise access. For 
example, users keep word processing documents, spreadsheet documents, calendars, telephone 
numbers and addresses, e-mail messages, financial information and so on. In general, users 
5 maintain this information on various personal computers, hand-held computers, pocket-sized 
computers, personal digital assistants, mobile phones and other electronic devices. In most 
cases, a user's data on one device is not accessible to another device, without some manual 
synchronization process or the like to exchange the data, which is cumbersome. Moreover, 
some devices do not readily allow for synchronization. For example, if a user leaves his cell 

53 10 phone at work, he has no way to get his stored phone numbers off the cell phone when at 

n 

home, even if the user has a computing device or similar cell phone at his disposal. As is 
evident, these drawbacks result from the separate devices each containing their own data. 

Corporate networks and the like can provide users with remote access to some of their 
data, but many users do not have access to such a network. For many of those that have 
15 access, connecting to a network with the many different types of devices, assuming such 
devices can even connect to a network, can be a complex or overwhelming problem. 

Moreover, even if a user has centrally stored data, the user needs the correct type of 
device running the appropriate application program to access that data. For example, a user 
with a PDA that maintains a user's contacts (e.g., names, addresses, telephone numbers and so 
20 on) with a simple address book-type taking application program ordinarily will not be able to 
use that program to open a list of contacts stored by an email application program or the like at 
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work. In general, this is because the data is formatted and accessed according to the way the 
application program wants it to be formatted. 

What is needed is a model wherein data is centrally stored for users, with a set of 
services that control access to the data with defined methods, regardless of the application 
5 program and/or device. 

SUMMARY OF THE INVENTION 

Briefly, the present invention provides a contacts service for central (e.g., Internet) 
access to per-user contact data, based on each user's identity, wherein the contacts service 

10 includes a schema that defines rules and a structure for the data, and also includes methods that 
provide access to the data in a defined way. Because the structure of the data is defined from 
the perspective of the data, not from that of an application program or a device, programs can 
communicate with the services to access the data, with existing knowledge of the format. In 
one implementation, the contacts schemas are arranged as XML documents, and the services 

15 provide methods that control access to the data based on the requesting user's identification, 
defined role and scope for that role. In this way, data can be accessed by its owner, and shared 
to an extent determined by the owner. Extensibility is defined into the schema. 

Other benefits and advantages will become apparent from the following detailed 
description when taken in conjunction with the drawings, in which: 

20 



BRIEF DESCRIPTION OF THE DRAWINGS 

FIGURE 1 is a block diagram representing an exemplary computer system into which 
the present invention may be incorporated; 

FIG. 2 is a block diagram representing a generic data access model in accordance with 
one aspect of the present invention; 

FIG. 3 is a representation of services for identity-based data access in accordance with 
one aspect of the present invention; and 

FIG. 4 is a block diagram representing a schema-based service for accessing data 
arranged in a logical content document based on a defined schema for that service in 
accordance with one aspect of the present invention. 

DETAILED DESCRIPTION 

EXEMPLARY OPERA TING ENVIRONMENT 

FIGURE 1 illustrates an example of a suitable computing system environment 100 on 
which the invention may be implemented. The computing system environment 100 is only one 
example of a suitable computing environment and is not intended to suggest any limitation as 
to the scope of use or functionality of the invention. Neither should the computing 
environment 100 be interpreted as having any dependency or requirement relating to any one 
or combination of components illustrated in the exemplary operating environment 100. 

The invention is operational with numerous other general purpose or special purpose 
computing system environments or configurations. Examples of well known computing 
systems, environments, and/or configurations that may be suitable for use with the invention 



include, but are not limited to: personal computers, server computers, hand-held or laptop 
devices, tablet devices, multiprocessor systems, microprocessor-based systems, set top boxes, 
programmable consumer electronics, network PCs, minicomputers, mainframe computers, 
distributed computing environments that include any of the above systems or devices, and the 
like. 

The invention may be described in the general context of computer-executable 
instructions, such as program modules, being executed by a computer. Generally, program 
modules include routines, programs, objects, components, data structures, and so forth, that 
perform particular tasks or implement particular abstract data types. The invention may also 
be practiced in distributed computing environments where tasks are performed by remote 
processing devices that are linked through a communications network. In a distributed 
computing environment, program modules may be located in local and/or remote computer 
storage media including memory storage devices. 

With reference to FIG. 1, an exemplary system for implementing the invention includes 
a general purpose computing device in the form of a computer 110. Components of the 
computer 110 may include, but are not limited to, a processing unit 120, a system memory 
130, and a system bus 121 that couples various system components including the system 
memory to the processing unit 120. The system bus 121 may be any of several types of bus 
structures including a memory bus or memory controller, a peripheral bus, and a local bus 
using any of a variety of bus architectures. By way of example, and not limitation, such 
architectures include Industry Standard Architecture (ISA) bus, Micro Channel Architecture 



(MCA) bus, Enhanced ISA (EISA) bus, Video Electronics Standards Association (VESA) 
local bus, and Peripheral Component Interconnect (PCI) bus also known as Mezzanine bus. 

The computer 1 10 typically includes a variety of computer-readable media. Computer- 
readable media can be any available media that can be accessed by the computer 110 and 
5 includes both volatile and nonvolatile media, and removable and non-removable media. By 
way of example, and not limitation, computer-readable media may comprise computer storage 
media and communication media. Computer storage media includes both volatile and 
nonvolatile, removable and non-removable media implemented in any method or technology 
for storage of information such as computer-readable instructions, data structures, program 

10 modules or other data. Computer storage media includes, but is not limited to, RAM, ROM, 
EEPROM, flash memory or other memory technology, CD-ROM, digital versatile disks 
(DVD) or other optical disk storage, magnetic cassettes, magnetic tape, magnetic disk storage 
or other magnetic storage devices, or any other medium which can be used to store the desired 
information and which can accessed by the computer 110. Communication media typically 

15 embodies computer-readable instructions, data structures, program modules or other data in a 
modulated data signal such as a carrier wave or other transport mechanism and includes any 
information delivery media. The term "modulated data signal" means a signal that has one or 
more of its characteristics set or changed in such a manner as to encode information in the 
signal. By way of example, and not limitation, communication media includes wired media 

20 such as a wired network or direct-wired connection, and wireless media such as acoustic, RF, 
infrared and other wireless media. Combinations of the any of the above should also be 
included within the scope of computer-readable media. 
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The system memory 130 includes computer storage media in the form of volatile and/or 
nonvolatile memory such as read only memory (ROM) 131 and random access memory 
(RAM) 132. A basic input/output system 133 (BIOS), containing the basic routines that help 
to transfer information between elements within computer 1 10, such as during start-up, is 
5 typically stored in ROM 131. RAM 132 typically contains data and/or program modules that 
are immediately accessible to and/or presently being operated on by processing unit 120. By 
way of example, and not limitation, FIG. 1 illustrates operating system 134, application 
programs 135, other program modules 136 and program data 137. 

The computer 110 may also include other removable/non-removable, 

":2 10 volatile/nonvolatile computer storage media. By way of example only, FIG. 1 illustrates a hard 

ij 
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12 disk drive 141 that reads from or writes to non-removable, nonvolatile magnetic media, a 

W 

|a magnetic disk drive 151 that reads from or writes to a removable, nonvolatile magnetic disk 

m 

* 152, and an optical disk drive 155 that reads from or writes to a removable, nonvolatile optical 

.2: ==t 

|3 disk 156 such as a CD ROM or other optical media. Other removable/non-removable, 

fU 

pi 15 volatile/nonvolatile computer storage media that can be used in the exemplary operating 
environment include, but are not limited to, magnetic tape cassettes, flash memory cards, 
digital versatile disks, digital video tape, solid state RAM, solid state ROM, and the like. The 
hard disk drive 141 is typically connected to the system bus 121 through a non-removable 
memory interface such as interface 140, and magnetic disk drive 151 and optical disk drive 155 
20 are typically connected to the system bus 121 by a removable memory interface, such as 
interface 150. 
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The drives and their associated computer storage media, discussed above and 
illustrated in FIG. 1, provide storage of computer-readable instructions, data structures, 
program modules and other data for the computer 110. In FIG. 1, for example, hard disk drive 
141 is illustrated as storing operating system 144, application programs 145, other program 
5 modules 146 and program data 147. Note that these components can either be the same as or 
different from operating system 134, application programs 135, other program modules 136, 
and program data 137. Operating system 144, application programs 145, other program 
modules 146, and program data 147 are given different numbers herein to illustrate that, at a 
minimum, they are different copies. A user may enter commands and information into the 

£3 10 computer 20 through input devices such as a tablet, or electronic digitizer, 164, a microphone 

C3 

163, a keyboard 162 and pointing device 161, commonly referred to as mouse, trackball or 

iy 

■|a touch pad. Other input devices not shown in FIG. 1 may include a joystick, game pad, satellite 

In 

- dish, scanner, or the like. These and other input devices are often connected to the processing 

s : 

O unit 120 through a user input interface 160 that is coupled to the system bus, but may be 

i;u 

15 connected by other interface and bus structures, such as a parallel port, game port or a 

universal serial bus (USB). A monitor 191 or other type of display device is also connected to 
the system bus 121 via an interface, such as a video interface 190. The monitor 191 may also 
be integrated with a touch-screen panel or the like. Note that the monitor and/or touch screen 
panel can be physically coupled to a housing in which the computing device 1 10 is 

20 incorporated, such as in a tablet-type personal computer. In addition, computers such as the 
computing device 1 10 may also include other peripheral output devices such as speakers 195 
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and printer 196, which may be connected through an output peripheral interface 194 or the 
like. 

The computer 110 may operate in a networked environment using logical connections 
to one or more remote computers, such as a remote computer 180. The remote computer 180 
may be a personal computer, a server, a router, a network PC, a peer device or other common 
network node, and typically includes many or all of the elements described above relative to 
the computer 110, although only a memory storage device 181 has been illustrated in FIG. 1. 
The logical connections depicted in FIG. 1 include a local area network (LAN) 171 and a wide 
area network (WAN) 173, but may also include other networks. Such networking 
environments are commonplace in offices, enterprise-wide computer networks, intranets and 
the Internet. For example, in the present invention, the computer system 1 10 may comprise 
source machine from which data is being migrated, and the remote computer 180 may 
comprise the destination machine. Note however that source and destination machines need 
not be connected by a network or any other means, but instead, data may be migrated via any 
media capable of being written by the source platform and read by the destination platform or 
platforms. 

When used in a LAN networking environment, the computer 1 10 is connected to the 
LAN 171 through a network interface or adapter 170. When used in a WAN networking 
environment, the computer 1 10 typically includes a modem 172 or other means for establishing 
communications over the WAN 173, such as the Internet. The modem 172, which may be 
internal or external, may be connected to the system bus 121 via the user input interface 160 or 
other appropriate mechanism. In a networked environment, program modules depicted 



relative to the computer 1 10, or portions thereof, may be stored in the remote memory storage 
device. By way of example, and not limitation, FIG. 1 illustrates remote application programs 
185 as residing on memory device 181. It will be appreciated that the network connections 
shown are exemplary and other means of establishing a communications link between the 
5 computers may be used. 

DATA ACCESS MODEL 

The present invention generally operates in an architecture / platform that connects 
network-based (e.g., Internet-based) applications, devices and services, and transforms them 

10 into a user's personal network which works on the user's behalf, and with permissions granted 
by the user. To this end, the present invention is generally directed to schema-based services 
that maintain user, group, corporate or other entity data in a commonly accessible virtual 
location, such as the Internet. The present invention is intended to scale to millions of users, 
and be stored reliably, and thus it is likely that a user's data will be distributed among and/or 

15 replicated to numerous storage devices, such as controlled via a server federation. As such, 
while the present invention will be generally described with respect to an identity-centric model 
that enables a user with an appropriate identity and credentials to access data by 
communicating with various core or other services, it is understood that the schema-based 
services described herein are arranged for handling the data of millions of users, sorted on a 

20 per-user-identity basis. Note that while u user" is generally employed herein for simplicity, as 
used herein the term "user" is really a substitute for any identity, which may be a user, a group, 
another entity, an event, a project, and so on. 
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As generally represented in FIG. 2, a data access model 200 includes a generic 
navigation module 202 through which applications 204 and the like may access a wide variety 
of identity-based data, such as maintained in an addressable store 206. To access the data, a 
common set of command methods may be used to perform operations on various data 
structures that are constructed from the data in the addressable store 206, even though each of 
those data structures may represent different data and be organized quite differently. Such 
command methods may describe generic operations that may be desired on a wide variety of 
data structures, and include, for example, insert, delete, replace, update, query or changequery 
methods. 

In accordance with one aspect of the present invention and as described in detail below, 
the data is accessed according to various schemas, with the schemas corresponding to identity- 
based services through which users access their data. As used herein, a "schema" generally 
comprises a set of rules that define how a data structure may be organized, e.g., what elements 
are supported, in what order they appear, how many times they appear, and so on. In addition, 
a schema may define, via color-coding or other identification mechanisms, what portions of an 
XML document (that corresponds to the data structure) may be operated on. Examples of 
such XML-based documents are described below. The schema may also define how the 
structure* of the XML document may be extended to include elements not expressly mentioned 
in the schema. 

As will be understood below, the schemas vary depending on the type of data they are 
intended to organize, e.g., an email-inbox-related schema organizes data differently from a 
schema that organizes a user's favorite websites. Further, the services that employ schemas 



may vary. As such, the generic navigation module 202 has associated therewith a navigation 
assistance module 208 that includes or is otherwise associated with one or more schemas 210. 
As will be understood, a navigation assistance module 208 as represented in FIG. 2 
corresponds to one or more services, and possesses the information that defines how to 
navigate through the various data structures, and may also indicate which command methods 
may be executed on what portions of the data structure. Although in FIG. 2 only one 
navigation assistance module 208 is shown coupled to the generic navigation module 202, 
there may be multiple navigation assistance modules that may each specialize as desired. For 
example, each navigation assistance module may correspond to one service. Moreover, 
although the navigation assistance module 208 is illustrated as a separate module, some or all 
of the operations of the navigation assistance module 208 may be incorporated into the generic 
navigation module 202, and vice versa. In one embodiment, the various data structures 
constructed from the schema and addressable store data may comprise XML documents of 
various XML classes. In that case, the navigation assistance module 208 may contain a 
schema associated with each of the classes of XML documents. 

The present invention provides a number of schema-based services that facilitate data 
access based on the identity of a user. Preferably, the user need not obtain a separate identity 
for each service, but rather obtains a single identity via a single set of credentials, such as with 
the Microsoft® Passport online service. With such an identity, a user can access data via these 
services from virtually any network connectable device capable of running an application that 
can call the methods of a service. 
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SERVICES AND SCHEMA S 

".NET My Services" comprises identity-centric services which may be generally 
implemented in XML (extensible Markup Language) Message Interfaces (XMIs). While the 
present invention will be described with respect to XML and XMI, it can readily be 
5 appreciated that the present invention is not limited to any particular language or set of 

interfaces. The .NET My Services model essentially corresponds to one implementation of the 
generic data access model 200 of FIG. 2. 

As generally represented in FIG. 3, .NET My Services 300 is implemented as a set of 
Web services 301-316, each bound to a .NET Identity (PUID, such as a Passport® unique 

M 

U 10 identifier similar to a globally unique indentifier when Passport* 1 is the authentication service). 

P 

The services 301-316 can communicate with one another via a service-to-service 

W 

in 



communications protocol (SSCP), described below. As also described below, each service 
presents itself as a set of XML documents that can be manipulated from an application 



I* 

13 program 202 (FIG. 2) or the like using a set of standard methods and domain-specific 

ry 

15 methods. To this end, a user device 320 (endpoint) running such application programs 

connects a user's applications to the services, and the data controlled by those services, such as 
over the Internet or an Intranet, such as over the Internet or an Intranet. Note that endpoints 
can be client devices, applications or services. In keeping with the present invention, virtually 
any device capable of executing software and connecting to a network in any means may thus 

20 give a user access to data that the user is allowed to access, such as the user's own data, or 
data that a friend or colleague has specified as being accessible to that particular user. 
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In general, a .NET Identity is an identifier assigned to an individual, a group of 
individuals, or some form of organization or project. Using this identifier, services bound to 
that identity can be located and manipulated. A general effect is that each identity (e.g., of a 
user, group or organization) has tied to it a set of services that are partitioned along schema 
boundaries and across different identities. As will be understood, the XML-document-centric 
architecture of .NET My Services provides a model for manipulating and communicating 
service state that is very different from prior data access models. The XML-document-centric 
approach, in conjunction with loose binding to the data exposed by the services, enables new 
classes of application programs. As will also be understood, the .NET My Services model 300 
presents the various services 301-316 using a uniform and consistent service and method 
model, a uniform and consistent data access and manipulation model, and a uniform and 
consistent security authorization model. 

In a preferred implementation, the .NET My Services model 300 is based upon open 
Internet standards. Services are accessed by means of SOAP (Simple Object Access Protocol) 
messages containing an XML payload. Service input and output is expressed as XML 
document outlines, and each of these document outlines conform to an XML schema 
document. The content is available to a user interacting with the .NET My Services service 
endpoint 320. 

Turning to FIG. 4, in the .NET My Services model, an application 400 requests 
performance of a method that operates on data structures. The application may make a 
request that is generic with respect to the type of data structure being operated upon and 
without requiring dedicated executable code for manipulating data structures of any particular 
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data type. To this end, the application first contacts a special my Services service 314 to obtain 
the information needed to communicate with a particular service 404, through a set of methods 
406 of that service 404. For example, the needed information received from the myServices 
service 3 14 includes a URI of that service 404. Note that the service 404 may correspond to 
5 essentially any of the services represented in FIG. 3, such as the myContacts service 305. 

The service 404 includes or is otherwise associated with a set of methods 406 including 
standard methods 408, such as to handle requests directed to insert, delete, replace, update, 
query or changequery operations on the data. The set of methods of a particular service may 
also include service specific methods 410. In general, the only way in which an application can 

H 

C3 10 communicate with a service are via that service's methods. 

O 

■fU Each service includes service logic 412 for handling requests and providing suitable 

?== 

responses. To this end, the service logic performs various functions such as authorization, 
a authentication, and signature validation, and further limits valid users to only the data which 

fs2» 

O they are permitted to access. The security aspect of a service is not discussed herein, except to 

fU 

jj 1 5 note that in general, for otherwise valid users, the user's identity determines whether a user can 
" access data in a requested manner. To this end, a roleMap 414 comprising service-wide 

roleList document templates 415 and scopes (e.g., part of the overall service's schema 416), in 
conjunction with user-based data maintained in an addressable store 418, determines whether a 
particular requested method is allowed, e.g., by forming an identity-based roleList document 
20 420. If a method is allowed, the scope information in the roleMap 414 determines a shape of 
data to return, e.g., how much content is allowed to be accessed for this particular user for this 
particular request. The content is obtained in accordance with a content document 422 in the 
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service's schema 416 and the actual user data corresponding to that content document in the 
addressable store 418. In this manner, a per-identity shaped content document 424 is 
essentially constructed for returning to the user, or for updating the addressable store, as 
appropriate for the method. Note that FIG. 4 includes a number of ID-based roleList 
documents and ID-based content documents, to emphasize that the service 406 is arranged to 
serve multiple users. Also, in FIG. 4, a system document 426 is present as part of the schema 
416, as described below. 

Returning to FIG. 3, in one implementation, access to .NET My Services 300 is 
accomplished using SOAP messages formatted with .NET My Services-specific header and 
body content. Each of the .NET My Services will accept these messages by means of an 
HTTP POST operation, and generate a response by "piggy-backing" on the HTTP Response, 
or by issuing an HTTP POST to a .NET My Services response-processing endpoint 320. In 
addition to HTTP as the message transfer protocol, .NET My Services will support raw SOAP 
over TCP, a transfer protocol known as Direct Internet Message Encapsulation (or DIME). 
Other protocols for transferring messages are feasible. 

Because .NET My Services are accessed by protocol, no particular client-side binding 
code, object models, API layers, or equivalents are required, and are thus optional. The .NET 
My Services will support Web Services Description Language (WSDL). It is not mandatory 
that applications wishing to interact with .NET My Services make use of any particular 
bindings, and such bindings are not described herein. Instead, the present invention will be 
generally described in terms of messages that flow between requestors of a particular service 
and the service endpoints. In order to interact with .NET My Services, a service needs to 
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format a .NET My Services message and deliver that message to a .NET My Services 
endpoint. In order to format a message, a client needs to manipulate XML document outlines, 
and typically perform some simple, known (public-domain) cryptographic operations on 
portions of the message. 

In accordance with one aspect of the present invention, and as described in FIG. 4 and 
below, in one preferred implementation, services (including the myContacts service 305) 
present three logical XML documents, a content document 422, roleList document 415 (of the 
roleMap 414), and a system document 426. These documents are addressable using .NET My 
Services message headers, and are manipulated using standard .NET My Services methods. In 
addition to these common methods, each service may include additional domain-specific 
methods. 

Each .NET MyServices service thus logically includes a content document 422, which 
in general is the main, service-specific document. The schema for this document 422 is a 
function of the class of service, as will become apparent from the description of the 
myContacts service's content document below. For example, in the case of the myContacts 
service 305, the content document presents data in the shape dictated by the .NET My 
Services .myContacts schema, whereas in the case of the " NET FavoriteWebSites" service 
308, the content document presents data in the shape dictated by a .NET myFavoriteWebSites 
schema. 

Each service also includes a roleList document 415 that contains roleList information, 
comprising information that governs access to the data and methods exported by the service 
404. The roleList document is manipulated using the NET My Services standard data 
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manipulation mechanisms. The shape of this document is governed by the NET My Services 
core schema's roleListType XML data type. 

Each service also includes a system document 426, which contains service-specific 
system data such as the roleMap, schemaMap, messageMap, version information, and service 
specific global data. The document is manipulated using the standard .NET data manipulation 
mechanism, although modifications are limited in a way that allows only the service itself to 
modify the document. The shape of this system document 426 may be governed by the system 
document schema for the particular service, in that each service may extend a base system 
document type with service specific information. 

As is understood, the present invention is generally based on schemas, which in general 
comprise a set of rules or standards that define how a particular type of data can be structured. 
Via the schemas, the meaning of data, rather than just the data itself, may be communicated 
between computer systems. For example, a computer device may recognize that a data 
structure that follows a particular address schema represents an address, enabling the computer 
to "understand" the component part of an address. The computer device may then perform 
intelligent actions based on the understanding that the data structure represents an address. 
Such actions may include, for example, the presentation of an action menu to the user that 
represents things to do with addresses. Schemas may be stored locally on a device and/or 
globally in a federation's "mega-store." A device can keep a locally-stored schema updated by 
subscribing to an event notification service (in this case, a schema update service) that 
automatically passes messages to the device when the schema is updated. Access to globally 
stored schemas is controlled by the security infrastructure. 
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GENERAL SCHEMA COMMONALITY 

The .NET My Services data is defined using annotated XSD schema files. The XSD 
files accurately type the data, but since XSD is a verbose and complex language, it is not a 
5 particularly efficient way to convey structure and meaning. Thus, for purposes of simplicity 
herein, the myContacts schemas are described below in terms of schema outlines with 
accompanying element/attribute descriptions. These document outlines accurately show the 
structure of the data contained within a service. However, because the present application is 
not viewable in color, the nodes, elements and/or attributes of the schema outlines (which may 

C3 10 be described as bold blue, or blue), are represented in the schema outlines as boldface type. 

C3 

IV Those described as underlined red, or red, are represented as underlined type, while others 

Si as; 

id 

1 7 referred to as black are represented in normal type. 

in 

The meaning of these bold (blue), underlined (red) and normal (black) items has 

Ls£r 

□ significance with respect to the data model and to the data language that accesses and 

m 

!r 15 manipulates the data (e.g., via the insert, delete, replace, update, query, changequery or other 

I J 

methods). For example, each document described below contains a root element having an 
element name that matches that of the service, e.g., the myContacts service has a root element 
named myContacts. The .NET My Services name for this item is the root. 

Documents contain elements that resemble first-class top-level objects, including, for 
20 example, <catDef/> , < myApplicationsSettings /> (other another name as appropriate) and 

<order/> Such items are denoted in the outlines as bold (blue), and may be identified using an 
<xdb:blue/> tag. Bold (blue) items define major blocks of data within a service. These node 
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sets are directly addressable by an identifier attribute, and their change status is tracked 
through a changeNumber attribute. Top-level bold blue items may be considered objects. As 
seen below, some bold (blue) objects contain nested bold blue objects. They usually contain 
frequently changing underlined (red) properties, which reduces the amount of synchronization 

5 traffic. Nested bold (blue) items may be considered property groups. 

Each bold blue item contains one or more underlined (red) items which are elements or 
attributes. These items may be identified using the < xdb:red/ > tag. These items are special in 
that they may be used within predicates (filters) to aid in xdb:bold blue selection. These items 
are also directly addressable and may be manipulated directly by the data manipulation 

10 language. 

Each colored red element may contain one or more non-colorized elements and 
attributes, which are valid and semantically meaningful XML items in the service document. 
Such items are opaque to the data language. These uncolored (i.e., non-bold or underlined) 
elements and attributes may not be addressed directly, may not be selected in a node selection 

15 operation, and may not be used in a predicate node test. Note that if one of these items is in 
the path to an underlined red item, it may be used in a location step to the underlined red item, 
but may not be used as the selected node. Note that being opaque does not mean that the item 
is not considered during schema validation, but rather means that the item may not be used in a 
predicate, may not be directly addressed, and may not be inserted by itself As can be readily 

20 appreciated, in this manner, the .NET My Services thus limits the granularity of access to 
nodes within the service document, since only xdb:bold blue and xdb:underlined red marked 
items are directly addressable, and only those elements and attributes tagged with the 
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xdb:underlined red annotation may be used in predicates to influence node selection. Using 
this technique, the .NET My Services storage system can efficiently manage indexes, increase 
the performance of node selection, partially shred the document data, and in general (because 
the node selections are well defined) fine-tune the node selection logic on a per-xdb:blue basis. 

5 The primary purpose of the xdb.blue is to define a base-level XML object that is designed to 
be operated on as a unit. The primary purpose of the xdb:red items is to aid in the selection of 
xdb:bold blues. The xdb:red items may be changed by the data language primitives so some 
level of fine-grained manipulation of the data is available, but only in very limited ways. 

Bold blue items have unique IDs, which are usually assigned by .NET My Services, and 

10 are returned from update operations within the new blueld node. In all cases, the order of 

xjnrBold blue follows the pre-order traversal of the document XML tree. Item IDs are UUIDs 
in the following format (/? stands for a hexadecimal digit): hhhhhhhh-hhhh-hhhh-hhhh- 
hhhhhhhhhhhh. 



13 In addition to identifiers, names and change numbers, nodes and especially red nodes 

IU 

15 may include creator identifiers, category information, and {any} fields. Category information 



enables data to be grouped and/or distinguished in some way, such as to share certain calendar 
information with golf buddies, send an email to immediately family, designate things such as 
which telephone number is the user's primary number, e.g., if a user has a second home, and so 
on. Fields of type "any" may comprise fully-typed, namespace-qualified fields that contain any 
20 type of content (e.g., free-form XML) therein. Such "any" fields thus allow extensibility of the 
schema, yet maintain the defined structure of a schema. 



In one implementation, the core data-manipulation language implemented by the .NET 
My -Services includes an insertRequest, or insert message. This primitive inserts any schema- 
valid XML fragment into a selected context, thereby changing the existing state of the 
document. A queryRequest, or message, retrieves data, such as to retrieve a document. 
Multiple queries may be specified in one request, and queries that select nothing are considered 
successful. It is possible to assert that the number of nodes in the selection falls in a given 
range. This is expressed using minOccurs and maxOccurs attributes. If a 
minOccurs/maxOccurs test fails on any node, the request is considered unsuccessful. Note that 
this is different from a failure code, which would be returned, for example, for a malformed 
request. 

A deleteRequest primitive deletes the selected nodes and all their children. Note that, 
just like for other requests, attributes may be selected as well as elements. Empty selections 
result in successful operations, similar to Query. The minOccurs/maxOccurs tests are 
supported wherever select is allowed. 

A replaceRequest primitive (replace message) is designed to replace the content of each 
of the selected nodes with the specified new content. Selected nodes themselves are not 
affected in any way. This may be considered as an atomic delete of the content of the selected 
node, followed by an insert. The content (text, attributes, elements) in the selected nodes are 
replaced with the new item specified in this message. The node type of the selected node and 
of the replacement node are thus required to be the same. The changequery request essentially 
returns result comrpising data that has changed. 
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As mentioned above, each of the services includes a RoleList document and scope 
information that describes which users have what type of access to which data. For example, a 
data owner will have read/write access to his or her own data, and can provide various types of 
rights to that data to other users based on their IDs, (e.g., read only to some users, read write 
to others). Each role list identifier may be associated with a scope, by which the kinds of data 
stored according to a given schema can be controlled per user. For example, a user can give a 
friend (with one identity) access via a service to a home telephone number, home address and 
so forth, but can give other users (with other identities) access only to a business telephone 
number. In general, a scope can be defined such that that it includes everything except any 
specifically listed items, or excludes everything except any specifically listed items. 

myContacts 

The .NET Contacts service comprises a repository for a user to store and track contact 
information and relationships for the various people and organizations that the user interacts 
with. To this end, each .NET My Services user has access to a logical contacts document 
which may contain multiple contact records. In general, the .NET Contacts service thus forms 
the foundation for an electronic address book, or a set of electronic relationships. This service 
contains a list of contacts, organized by category, wherein a contact is a schema element 
containing an identifier (id) for the contact in the .NET My Services id space. A contact has a 
local name for that contact, a set of categories that the contact belongs to, (distribution list's, 
groups, and classifications), an address, as defined by the .NET Address schema, and a set of 
profile information (as defined by a corresponding NET Profile schema). To this end, the 
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.NET Contacts schema includes at least some of the .NET Profile service information 
including, but not limited to, name, addresses, phone numbers and email addresses, as well as 
allowing the owner to control how the contacts are categorized. 

Contact information stored within .NET Contacts can be derived from the owner's 
5 .NET Address and .NET Profile services. For example, if a user X wishes to add someone 
named Y as a contact in the user's .NET Contacts service, the information used to populate 
this contact can be queried from user Y's .NET Address and .NET Profile services. User Y's 
access control mechanisms determine how much information from his or her .NET Address 
and .NET Profile services are allowed to be seen. From the user's perspective, the user can 
10 similarly control visibility of individual contacts and grant various levels access to their list of 
contacts to applications and other users based on the role templates with respect to each user's 
relative role. Thus, for example, with the user's consent, an application could populate a 
selection box with the user's contacts. From this box, the user could select a contact and the 
application could fill out the "Ship To:" fields (name, address, city, state and zip) for the 
15 contact automatically, such as when making a gift purchase. 

The .NET Contacts service is designed to support live contacts. In this mode of 
operation, the queries described above that populate a contact happen automatically each time 
a change occurs in a subscribed-to to contact. This synchronization can be enabled or 
suppressed on a contact-by-contact basis. Users and applications can negotiate a subscription 
20 to another user's Profile document via the LiveContacts mechanism. When subscribed, the 

informational nodes become read-only for that contact and automatically update when changed 
by the Profile owner. The user can still control categorization, and notes for the LiveContact 
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entry. The aforementioned service-to-service communications protocol (SSCP) provides a 
highly efficient, robust mechanism for such automatic updates. Throughout the following 
examples, an "hs" as in <hs: scope . . > represents the namespace or schematic that may be 
used to interpret the corresponding element. 

myContacts / Roles 

The myContacts service controls access by using the roleTemplates rtO, rtl, rt2, rt3 and 
rt99, using the following scopes: 

scope allElements 

\t 10 <hs:scope id=7215df55-e4af-449f-aSe4-72alf7c6a987> 
;f <hs:shape base=t> 

Jr{ </hs:shape> 
1^ </hs:scope> 

■H 15 scope only SelfElements 

W <hs:scopeid=al59c93d-4010-4460-bc34-5094c49cl633> 
<hs: shape base=nil> 

<hs:include select=//*[@creator= i $callerld , ]/> 
</hs:shape> 



S3 



fU 20 </hs:scope> 

a 



scope onlySeirSubscriptionElenients 

<hs:scope id=b7f05a6d-75cd-4958-9dfb-f532ebbl7743> 

<hs: shape base=nil> 
25 <hs:include select=//subscription[@creator= t $callerId , ]/> 

</hs:shape> 
</hs:scope> 

scope onlyPublicElements 

30 <hs:scope id=da025540-a0c0-470f-adcf-9fl)7e5a5ec8f> 

<hs: shape base=nil> 

<hs : include select^//* [cat/@ref = 1 h s : publi c 5 ]/> 
<hs:include select=//subscription[@creator== i $callerId']/> 

</hs:shape> 
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</hs:scope> 



The myContacts roleTemplate rtO role gives complete read/write access to the 
information within the content document of the service being protected through this 
roleTemplate. 

The following table illustrates the available methods and the scope in effect when 

accessing the myContacts service through that method while mapped to this roleTemplate: 

TABLE -myContacts roleTemplate rtO 
method ijscope/name 

query allElements 

insert allElements 

replace allElements 

delete allElements 

update allElements 

The myContacts roleTemplate rtl role gives complete read access to all information 
within the content document of the service being protected through this roleTemplate. 
Applications mapping to this role also have a limited ability to write to information in the 
content document. They may create nodes in any location, but may only change/replace, or 
delete nodes that they created. The following table illustrates the available methods and the 
scope in effect when accessing the myContacts service through that method while mapped to 
this roleTemplate: 

TABLE -myContacts roleTeni plate rtl 
method scope/name 

jquery ijallElements 
ijinsert iionlySelfElements \ 

jreplace iionlySelfElements \ 
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jdelete jonlySelfElements j 

The myContacts roleTemplate rt2 role gives complete read access to all information 
within the content document of the service being protected through this roleTemplate. 
Applications mapping to this role have very limited write access and are only able to create and 
manipulate their own subscription nodes. The following table illustrates the available methods 
and the scope in effect when accessing the myContacts service through that method while 
mapped to this roleTemplate. 



TABLE -myContacts roleTemplate rt2 



method 


scope/name 


iiquery 


jallElements 


Unsert 


jonlySelfSubscriptionElements j 


ireplace 


onlySelfSubscnptionElements 


delete 


jonlySelfSubscriptionElements j 



The myContacts roleTemplate rt3 role gives limited read access to information within 
the content document that is categorized as "public." The following table illustrates the 
available methods and the scope in effect when accessing the myContacts service through that 
method while mapped to this roleTemplate: 
TABLE -myContacts roleTemplate rt3 



method 


scope/name 


ijQuery 


fonlyPublicElements ; 



The myContacts roleTemplate rt99 blocks access to the content document. Note that 
lack of a role in the roleList has the same effect as assigning someone to rt99. No methods / 
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scope are in effect when accessing the myContacts service while mapped to this rt99 
roleTemplate. 



myContacts / Content 

The content document is an identity centric document, with its content and meaning a 
function of the user identifier (puid) used to address the service. Accessing the document is 
controlled by the associated roleList document. The following table comprises a schema 
outline that illustrates the layout and meaning of the information found in the content 
document for the myContacts service. 



<m:mvContacts chaneeNumber= " ..." instanceld=" ..." 

xmlns:m=" http://schemas.microsoft.com/hs/2001/10/myContacts" 
xmlns:mp=" http://schemas.microsoft.com/hs/2001/10/myProfile" 
xmlns:mc=" http://schemas.microsoft.com/hs/2001/10/myCalendar" 
xmlns:hs- ' http://schemas.microsoft.com/hs/2001/10/core" >i..i 

<m:contact synchronize - ' ..." changeNumber =" ..." id=" ..." creator ^" ..." >o..unbounded 
< m:cat ref=" ..." >n „nhn„nd«i< /m:cat > 

<m:name changeNumber =" ..." id= ih ..." creator^ * ..." >o.unbounded 

< mp:cat ref- ' ..." >o unboundcd < /mElcat > 

<mp:title xml:lang=" ..." dir=" ..." > 0 ..)</mp:title> 

< mp:givenName xml:lang=" ..." dir=" ..." >n i</ mp:givenName > 

<mp:middleName xml:lang=" ..." dir= 4i ..." > 0 . 1 </mp:middleName> 

< mp:surname xml:lang=" ..." dir=*' ..." >a i</ mn:surname > 

<mp:suffix xml:lang=" ..." dir=" ..." > 0 ..i</mp:suffix> 

< mp:fileAsName xml:lang=" ..." dir=" ..." >n ,</ mp:fileAsName > 

{any} 
</m:name> 
< m:puid >Q i </ m:puid > 

<m:specialDate calendarType =ii ..." -m}.. unbounded 

< mp:cat ref- ' ..." > 0 i < /mp:cat > 

<mp :date>i .. i </mp :date> 

{anvf 
</m:specialDate> 
<m:picture> 0 ..unboundcd 

< mp:cat ref- 4 ..." >n i</ mp:cat > 

<mp:url>i..i</mp:url> 

(any} 

</m:picture> 
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<m:gender>o..i</m:gender> 
<m:notes xml:lang=" ..." dir=" ..." > 0 ..i</m:notes> 
<m:address changeNumber = " ..." id= : ..." creator^* ..." > 0 ..unbounded 
< hs:cat ref=" ..." >o..unbounded</hsicat> 

<hs:officialAddressLine>™l:lang= ;i ..." dir= ;i ..." > 0 ..i</hs:officialAddressLine> 

<hs:intemalAddressLinexml:lang=" ..." dir= ; " ..." > 0 ..i</hs:intemalAddressLine> 

<hs:primaryCity xml:Iang=" ..." dir= ;; ..." >o..i</hs:primaryCity> 

<hs:secondaryCity xml:lang=" ..." dir= ; ' ..." > 0 ..j</hs:secondaryCity> 

<hs:subdivision xml:lang-" ..." dir- " ..." > 01 </hs:subdivision> 

<hs :postalCode> 0 .. i </hs :postaICode> 

<hs : count ry Code> 0 .. 1 </hs :cou n t ryC ode> 

<hs : latitude^,, i </hs: latitude> 

<hs : longitude> 0 .. i </hs : longitude> 

<hs:elevation>o..i</lis:elevation> 

<hs:velocity>o..i 

<hs : speed> 0 .. i </hs : speed> 

<hs :di rection>o.. i </hs : di rect ion> 
</hs:velocity> 

<hs : confidence^.. 1 </hs : confi dence> 
^siprecision^.^/hsiprecisioi^ 
{any} 
</m:address> 

<m:emailAddress changeNumbei - ' ..." id=" ..." creator =" ..." >o.. U nbounded 
< mp:cat ref=" ..." >n nnhnnnH,H</ mp:cat > 
< mp:email >i i</ mp:email > 

<mp:name xml:lang=" ..." dir= ; * ..." > 0 ..i</mp:name> 
fanvf 
</m:emailAddress> 

<m:webSite changeNumber =" ..." id=" ..." creator=" ..." >o ..unbounded 

< mp:cat ref=" ..." >p i</ mp:cat > 

<mp:url>i..i</mp:url> 

{ami 
</m:webSite> 
<m: screenName>o..unbounded 

< mp:cat ref- 4 ..." > f , t </ mp:cat > 

< mp:name xml:lang- * ..." dir- * ..." >\ l </ mp:name > 

fanvf 
</m:screenName> 

<m:telephoneNumber changeNumber -" ..." id= ;i ..." creator =i ..." >o ..unbounded 
< hs:cat ref=" ..." >o unbounded</hsicat > 
<hs:countr\ ; Code>o..i</lis:countn'Code> 
<hs:nationalCode>i..i</lis:nationalCode> 
< hs:number> i i< /hs:number > 
<hs :numberExtension>o. i </lis :numberExtension> 
<hs:pin> 0 ..i</hs:pin> 
fanvf 

</m:telephoneNumber> _ 



<m:identificationNumber>o..unboundcd 
< mp:cat ref=" ..." >n i</ mp:cat > 
<mp : number> i i </mp : number> 
(anvf 

</m:identificationNumber> 

<m:workInformation changeNumber - ' ..." id- 4 ..." creator =ii ..." >o unbounded 
< mp:cat ref - ' ..." >n „nhn,mH^</ mp:cat> 
<mp:profession xml:lang=" ..." dir=" ..." > 0 ..i</mp:profession> 
<mp:jobTitle xml:lang=" ..." dir= u .."> 0 .j</mp:jobTitIe> 
<mp:ofFiceLocation xml:lang=" ..." dir=" ..." > 0 ..i</mp:officeLocation> 

<mp:co\vorkerOrDepartment>o. unbounded 

<hs:name xml:lang=" ..." dir=" ..." > 0 ..,</lis:name> 

<hs:puid> 0 ..i</hs:puid> 

<hs : email> 0 .. 1 </hs : email> 

< hs:cat ref=" ..." >i i</ hs:cat > 
</mp:co\vorkerOrDepartment> 

fenxL 

</m:workInformation> 

<m:userReference> 0 ..unbounded 

<hs:name xml:lang- 6 ..." dir=" ..." > 0 ..t</hs:name> 

<hs:puid> 0 .i</hs:puid> 

<hs :email> 0 .. 1 </hs :email> 

<hs:cat ref=" ..." >i i</ hs:cat > 
</m:userReference> 
<m:securityCertificate>o..unbounded 

< mp;cat ref- 4 ..." >n U nbounded < /niBIcat> 

<mp : certificate> i i </mp :certificate> 
</m:securityCertificate> 
{any} 
</m:contact> 

<m:subscription changeNumber - ' ..." id =ii ..." creator =" ..." >o unbounded 

<hs:trigger select=" ..." mode-'..." baseChangeNumber =* ..." > 1 .. l </lis:trigger> 

<hs:expiresAt>o..i</hs:e\piresAt> 

<hs:context uri=" ..." > 1m1 /i?m7 </lis:context> 

<hs:to>i.i</hs:to> 
</m:subscription> 
{any} 
</m:myContacts> 



The meaning of the attributes and elements shown in the table are set forth below, 
wherein in the syntax used in the table, boldface type corresponds to a blue node, and 
underlined type to a red node, as described above, and the minimum and maximum occurrence 
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information (0, 1, unbounded) indicates whether an element or attribute is required or optional, 
and how many are possible. 

The /my Contacts (minOccurs=l maxOccurs=l) element encapsulates the content 
document for this service. This element establishes a global cache scope for the service and 
contains other root-level system attributes for this instance of the service. 

The /myContacts/@changeNumber (minOccurs=0 maxOccurs=l) changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read-only to 
applications. Attempts to write this attribute are silently ignored, e.g., without generating an 
error. 

The /myContacts/@instanceId (string minOccurs=0 maxOccurs=l) attribute is a unique 
identifier typically assigned to the root element of a service. It is a read-only element and 
assigned by the .NET My Services system when a user is provisioned for a particular service. 

The /myContacts/contact (minOccurs=0 maxOccurs=unbounded) identifies a particular 
contact. The /myContacts/contact/@synchronize (string minOccurs=0 maxOccurs=l) attribute 
controls and/or enables synchronization of this contact node. When enabled, (e.g., value of 
"yes" ), .NET My Services will attempt to keep the contact nodes synchronized with the 
reference data stored in the referenced PUID's myProfile default store, subject to permission. 
A value of "no" indicates that the system should not attempt to keep this contact node 
synchronized. 

The /myContacts/contact/@changeNumber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 



This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to applications. Attempts to write this attribute are silently ignored. 

The /myContacts/contact/@id (minOccurs=0 maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
5 generate and assign this ID during an insertRequest operation, or possibly during a 
* replaceRequest Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read-only 
and attempts to write it are silently ignored. 

The /myContacts/contact/@creator (string minOccurs=0 maxOccurs=l) attribute 
S3 10 identifies the creator in terms of userld, appld, and platformld of the node. 

The /myContacts/contact/cat (minOccurs=0 maxOccurs=unbounded) element is used 
to categorize the element that contains it by referencing a global category definition in either 
the .NET Categories service system document or an external resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
1 5 the .NET Categories service for a particular puid. 

The /myContacts/contact/cat/@ref (anyURI minOccurs=0 maxOccurs=l) attribute 
references a category definition (<catDef/>) element using the rules outlined in the 
myCategories section of the present application. 

The /myContacts/contact/name (minOccurs=0 maxOccurs=unbounded) element 
20 encapsulates a name associated with the identity. An identity can have multiple names 

associated with it. These name nodes are not intended to be used for storing screen names or 
other electronic names, but rather to store a commonly used name for the entity. Names 
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contain five parts and are meant to be combined in proper order, with spaces separating the 
parts and empty content parts excluded. 

The /myContacts/contact/name/@changeNumber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to applications. Attempts to write this attribute are silently ignored. 

The /myContacts/contact/name/@id (minOccurs=0 maxOccurs=l) attribute is a 
globally unique ID assigned to this element by .NET My Services. Normally, .NET My 
Services will generate and assign this ID during an insertRequest operation, or possibly during 
a replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read-only 
and attempts to write it are silently ignored. 

The /myContacts/contact/name/@creator (string minOccurs=0 maxOccurs=l) attribute 
identifies the creator in terms of userld, appld, and platformld of the node. The 
/myContacts/contact/name/cat (minOccurs=0 maxOccurs^unbounded) element is used to 
categorize the element that contains it by referencing a global category definition in either the 
.NET Categories service system document or an external resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
the .NET Categories service for a particular puid. The /myContacts/contact/name/cat/@ref 
(anyURI minOccurs=0 maxOccurs=l) attribute references a category definition (<catDef7>) 
element using the rules outlined in the myCategories section of the present application. 



The /myContacts/contact/name/title (string minOccurs=0 maxOccurs=l) optional 
element is designed to store a title or prefix associated with the name. Examples are 'Mr.', 
'Mrs.', T)r.\ or any other commonly used name title or prefix. The 

/myContacts/contact/name/title/@xml:lang (minOccurs=l maxOccurs=l) is a required attribute 
5 used to specify an ISO 639 language code or an ISO 3 166 country code as described in RFC 
1766 (wherein ISO stands for International Organization for Standardization and RFC stands 
for Request For Comment). The value of this attribute indicates the language type of the 
content within this element. 

The /myContacts/contact/name/title/@dir (string minOccurs=0 maxOccurs=l) optional 
C3 10 attribute specifies the default layout direction for the localized string. Valid values are rtl (right 
[J to left), and ltr (left to right). 

The /myContacts/contact/name/givenName (string minOccurs=0 maxOccurs=l) 
optional element is meant to store the first portion of a name. The 
£3 /myContacts/contact/name/givenName/@xml:lang (minOccurs=l maxOccurs=l) required 

15 attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 

described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myContacts/contact/name/givenName/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left), and ltr (left to right). 
20 The /myContacts/contact/name/middleName (string minOccurs=0 maxOccurs=l) 

optional element is meant to store the middle portion or initial of a name. The 
/myContacts/contact/name/middleName/@xml:lang (minOccurs=l maxOccurs=l) required 
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attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myContacts/contact/name/middleName/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
5 Valid values are rtl (right to left), and ltr (left to right). 

The /myContacts/contact/name/surname (string minOccurs=0 maxOccurs=l) optional 
element is meant to store the last portion of a name. The 

/myContacts/contact/name/surname/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 

C3 10 described in RFC 1766. The value of this attribute indicates the language type of the content 

~=? 

I U within this element. The /myContacts/contact/name/surname/@dir (string minOccurs=0 

H 

H maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 

Valid values are rtl (right to left), and ltr (left to right). 

The /myContacts/cont act/name/suffix (string minOccurs=0 maxOccurs=l) optional 

IU 15 element is designed to store a suffix associated with the name. Examples include 'Jr.', 'Sr.', 

p 

'IIP, or any other commonly used name suffix. The 

/myContacts/contact/name/suffix/@xml:lang (minOccurs^l maxOccurs=l) required attribute is 
used to specify an ISO 639 language code or an ISO 3166 country code as described in RFC 
1766. The value of this attribute indicates the language type of the content within this element. 
20 The /myContacts/contact/name/suffix/@dir (string minOccurs=0 maxOccurs=l) optional 

attribute specifies the default layout direction for the localized string. Valid values are rtl (right 
to left), and ltr (left to right). 
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A complete name is usually a combination of title, givenName, middleName, surname, 
and suffix. The /myContacts/contact/name/fileAsName (string minOccurs=0 maxOccurs=l) 
optional element is present to indicate that a different order should be used, or that the identity 
prefers to have the name filed differently. The 
5 /myContacts/contact/name/fileAsName/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. 

The /myContacts/contact/name/fileAsName/@dir (string minOccurs=0 maxOccurs=l) 

H 

C3 10 optional attribute specifies the default layout direction for the localized string. Valid values are 

O 

ru rtl (right to left), and ltr (left to right). The /myContacts/contact/name/{any) (minOccurs=0 

f " maxOccurs=unbounded) allows the My Contacts section to be extended with respect to name 

in 

.-e information. 

13 The /myContacts/contact/puid (string minOccurs=0 maxOccurs=l) element is used to 

IU 

2J 15 specify a Passport Unique ID (PUID). The ID itself is in raw form, it is not encrypted in any 
? " way. The /myContacts/contact/specialDate (minOccurs=0 maxOccurs=unbounded) element 

encapsulates a special date that is important to this entity. Multiple special date nodes may 
exist. This is not a substitute for dates stored on an entity's myCalendar service, but rather 
intends to provide a convenient place to store a birth date, an anniversary date, and so on, 
20 because these dates are frequently imported into a contact record. 
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The /myContacts/contaet/specialDate/@calendarType (string minOccurs=0 



maxOccurs=l) field identifies an enumeration which determines the kind of calendar event this 
is, based on the following table, (which can be expanded): 





| Value 


Enumeration Constant 


Description | 








Unknown Calendar; system default 






lUCr'AT ATT PAT cwnABC 


(HSCAL GREGORIAN US) 






HSCALGREGORIAN 


Gregorian (localized) calendar 






HSCAL GREGORIAN US 


iGregorian (U.S.) calendar 




pT 


[HisCALJAPAN 


Japanese Emperor Era calendar 






HSCAL_TAIWAN 


Taiwan Era calendar 






Ihscal^kcorea 


Korean Tangun Era calendar 




;6 


iHSCALJlijRI 


iHijri (Arabic Lunar) calendar 




w 


1hsc7j7jhai 


Thai calendar 


o 


s 


HSCAL^HEBREW 


Hebrew (Lunar) calendar 


ry 




HSCAL_GREGORIAN_ME_FRENCH 


iGregorian Middle East French calendar 

: J ; 


iy 


fio 




Gregorian Arabic calendar 




jn 


IhSCAL_GREGORIAN_XLIT_ENGLISH iGregorian Transliterated English calendar] 


to 


12 


1hSCAL_GREGORIAN_XLIT_FRENCH Gregorian Transliterated I French i calendar j 




}l3 


HSCAL_KOREA_LUNAR 


Default Korea Lunar calendar 


>:z=5 

■?H 


fl4 


HSCALJAPANLUNAR 


Default Japanese Lunar calendar 


■■= hS 

ru 


|15 


Ihsc :aljchinesejlun ar 


^Chinese Lunar calendar 


i-J 


:|i6 


[hscal^sa^ 


ilndian Saka calendar 


1 = 


17 


HSCALLUNARETOCHN 


iChinese Zodiac calendar 




|l8 


HSCAL_LUNAR_ETO_KOR 


IKorean Zodiac calendar 






"IhscaT lunar ROKUYOU 


Japanese Lucky days calendar 



5 The /myContacts/contact/specialDate/cat (minOccurs=0 maxOccurs=l) element is used 

to categorize the element that contains it by referencing a global category definition in either 
the .NET Categories service system document or an external resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
the .NET Categories service for a particular puid. The 
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/myContacts/contact/specialDate/cat/@ref (anyURI minOccurs=0 maxOccurs=l) attribute 
references a category definition (<catDef/>) element using the rules outlined in the 
myCategories section of the present application (/myContacts/contact/specialDate/date (date 
minOccurs=l maxOccurs=l)). 

5 The /myContacts/contact/specialDate/{any} (minOccurs=0 maxOccurs=unbounded) 

provides date extensibility. The /myContacts/contact/picture (minOccurs=0 
maxOccurs=unbounded) optional element encapsulates a URL that points to a picture of the 
identity. The /myContacts/contact/picture/cat (minOccurs=0 maxOccurs=l) element is used to 
categorize the element that contains it by referencing a global category definition in either the 

10 .NET Categories service system document or an external resource containing category 

definitions, or by referencing an identity centric category definition in the content document of 
the NET Categories service for a particular puid. The /myContacts/contact/picture/cat/@ref 
(anyURI minOccurs=0 maxOccurs=l) attribute references a category definition (<catDef7>) 
element using the rules outlined in the myCategories section of the present application. The 

15 /myContacts/contact/picture/url (string minOccurs=l maxOccurs=l) element contains the URL 
that points to the actual picture. The /myContacts/contact/picture/{any} (minOccurs=0 
maxOccurs=unbounded) provides for picture-related extensibility. 

The /myContacts/contact/gender (string minOccurs=0 maxOccurs=l) element specifies 
the gender for this entity. There can only be a single gender associated with an entity. The 

20 format of this element is a single, 7-bit ASCII character with one of two possible values: l m' 
for male, and T for female. The /myContacts/contact/notes (string minOccurs=0 
maxOccurs=l) element contains free-form notes related to this contact. The 
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/myContacts/contact/notes/@xml:lang (minOccurs=l maxOccurs=l) required attribute is used 
to specify an ISO 639 language code or an ISO 3166 country code as described in RFC 1766. 
The value of this attribute indicates the language type of the content within this element. 
The /myContacts/contact/notes/@dir (string minOccurs=0 maxOccurs=l) optional 
5 attribute specifies the base direction of directionally neutral text. Possible values include rtl 
(right to left), or ltr (left to right). The /myContacts/contact/address (minOccurs=0 
maxOccurs=unbounded) element encapsulates a geographic address. The contained nodes 
describe the geographic address in detail. Typical use is one address element for each 
geographical address for this identity, e.g., a user with a primary home and a vacation home 
10 might have two address elements in this service. 

The /myContacts/contact/address/@changeNumber (minOccurs=0 maxOccurs=l) 
J y changeNumber attribute is designed to facilitate caching of the element and its descendants. 

This attribute is assigned to this element by the .NET My Services system. The attribute is 

3 . 

p read-only to applications. Attempts to write this attribute are silently ignored. 

?y 

fU 15 The /myContacts/contact/address/@id (minOccurs=0 maxOccurs=l) attribute is a 

O 

globally unique ID assigned to this element by NET My Services. Normally, .NET My 
Services will generate and assign this ID during an insertRequest operation, or possibly during 
a replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read-only 
20 and attempts to write it are silently ignored. 

The /myContacts/contact/address/@creator (string minOccurs=0 maxOccurs=l) 
attribute identifies the creator in terms of userld, appld, and platformld of the node. The 



C3 

ru 



in 
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/myContacts/contact/address/cat (minOccurs=0 maxOccurs=unbounded) element is used to 
categorize the element that contains it by referencing a global category definition in either the 
.NET Categories service system document or an external resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
the .NET Categories service for a particular puid. 

The /myContacts/contact/address/cat/@ref (anyURI minOccurs=0 maxOccurs=l) 
attribute references a category definition (<catDef/>) element using the rules outlined in the 
myCategories section of the present application. The 

/myContacts/contact/address/officialAddressLine (string minOccurs=0 maxOccurs=l) element 



13 10 contains the most precise, official line for the address relative to the postal agency servicing the 

O 

f y area specified by the city(s)/postalCode. When parsing an address for official postal usage, this 

: y element contains the official, parsable address line that the regional postal system cares about. 

m 

Typical usage of this element would be to enclose a street address, post office box address, 

O private bag, or any other similar official address. Internal routing information like department 

ru 

fU 15 name, suite number within a building, internal mailstop number, or similar properties should be 

O 



placed within the internalAddressLine element. The 

/myContacts/contact/address/officialAddressLine/@xml:lang (minOccurs=l maxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
20 within this element. The /myContacts/contact/address/officialAddressLine/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and ltr (left to right). 
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The /myContacts/contact/address/internalAddressLine (string minOccurs=0 
maxOccurs=l) element contains internal routing information relative to the address specified 
by the officialAddressLine. Items like department name, suite number within a building, 
internal mailstop number, or similar properties should be placed within this element. 
5 The /myContacts/contact/address/internalAddressLine/@xml:lang (minOccurs=l 

maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language type 
of the content within this element. 

The /myContacts/contact/address/internalAddressLine/@dir (string minOccurs=0 

0 10 maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 

C3 

1 U Valid values are rtl (right to left), and ltr (left to right). The 

W ZmyContacts/contact/address/primaryCity (string minOccurs=0 maxOccurs=l) element defines 

I* 

yl the primary city for this address. The /myContacts/contact/address/primaryCity/@xml:lang 

jrg (minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 

fU 

IU 15 or an ISO 3 1 66 country code as described in RFC 1 766. The value of this attribute indicates 
the language type of the content within this element. The 

/myContacts/contact/address/primaryCity/@dir (string minOccurs=0 maxOccurs=l) optional 
attribute specifies the default layout direction for the localized string. Valid values are rtl (right 
to left), and ltr (left to right). 
20 The /myContacts/contact/address/secondaryCity (string minOccurs=0 maxOccurs=l ) 
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optional element defines the secondary city for this address. Example types for this element 
include city district, city wards, postal towns, and so on. The 

/myContacts/contact/address/secondaryCity/@xml:lang (minOccurs=l maxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 
5 described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myContacts/contact/address/secondaryCity/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and ltr (left to right). 
The /myContacts/contact/address/subdivision (string minOccurs=0 maxOccurs=l) element 
10 contains the official subdivision name within the country or region for this address. In the 

United States, this element would contain the two-letter abbreviation for the name of the state. 
This element is also commonly treated as the "first order admin subdivision" and will typically 
contain subdivision names referring to administrative division, Bundesstaat, canton, federal 
district, province, region, state or territory. The 
15 /myContacts/contact/address/subdivision/@xml:lang (minOccurs=l maxOccurs=l) is a 

required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element, while the /myContacts/contact/address/subdivision/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
20 localized string. Valid values are rtl (right to left), and ltr (left to right). 

The /myContacts/contact/address/postalCode (string minOccurs=0 maxOccurs=l) 
element contains the official postal code for this address. The 
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/myContacts/contact/address/countryCode (string minOccurs=0 maxOccurs=l) element 
contains the 2 letter ISO-3 166 id of the country, dependency, or functionally equivalent region 
for this address. 

The /myContacts/contact/address/latitude (string minOccurs=0 maxOccurs=l) element 
5 specifies the latitude value for this address in units of decimal degrees while the 

/myContacts/contact/address/latitude/longitude (string minOccurs=0 maxOccurs=l) element 
specifies the longitude value for this address in units of decimal degrees. The 
/myContacts/contact/address/latitude/elevation (string minOccurs=0 maxOccurs=l) element 
specifies the elevation above sea level with respect to WGS84 geodetic datum, in units of 

p 10 meters. Geodetic datum WGS84 is required for these elements. The 

o 

fi /myContacts/contact/address/latitude/velocity (minOccurs=0 maxOccurs= 1 ) element specifies 

W the last reported velocity associated with this address. Of course for fixed addresses, the 

velocity node would either not be present, or speed would be zero indication stationary 

iS position. The /myContacts/contact/address/latitude/velocity/speed (string minOccurs=0 

fU 

f U 15 maxOccurs=l) element specifies the last known speed associated with this report in units of 
** meters per second. The /myContacts/contact/address/latitude/velocity/direction (string 

minOccurs=0 maxOccurs=l) element specifies the last known direction associated with this 
report in units of degrees decimal. The /myContacts/contact/address/latitude/confidence 
(string minOccurs=0 maxOccurs=l) element specifies a percentage value that indicates the 
20 confidence value that this location is accurate within the specified precision. The 

/myContacts/contact/address/latitude/precision (string minOccurs=0 maxOccurs=l) element 
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specifies the precision in meters of this location. The value defines a spherical zone that the 
location falls within. 

The /myContacts/contact/address/{any} (minOccurs=0 maxOccurs=unbounded) field ' 
allows extensibility of address information. 

5 The /myContacts/contact/emailAddress (minOccurs=0 maxOccurs=unbounded) 

element encapsulates an electronic address for this entity, specifically, it contains an email 
address associated with this identity. This element may be repeated any number of times. 
Typical use is one emailAddress element for each email address associated with this identity. 
The /myContacts/contact/emailAddress/@changeNumber (minOccurs=0 

10 maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read-only to applications. Attempts to write this attribute are silently ignored. 
The /myContacts/contact/emailAddress/@.id (minOccurs=0 maxOccurs=l) attribute is a 
globally unique ID assigned to this element by .NET My Services. Normally, .NET My 

15 Services will generate and assign this ID during an insertRequest operation, or possibly during 
a replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read-only 
and attempts to write it are silently ignored. 

The /myContacts/contact/emailAddress/@creator (string minOccurs=0 maxOccurs=l) 

20 attribute identifies the creator in terms of userld, appld, and platformld of the node. The 

/myContacts/contact/emailAddress/cat (minOccurs=0 maxOccurs=unbounded) element is used 
to categorize the element that contains it by referencing a global category definition in either 



-44- 



the .NET Categories service system document or an external resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
the .NET Categories service for a particular puid. 

The /myContacts/contact/emailAddress/cat/@ref (anyURI minOccurs=0 maxOccurs=l) 
5 attribute references a category definition (<catDef/>) element using the rules outlined in the 
myCategories section of the present application. The /myContacts/contact/emailAddress/email 
(string minOccurs=l maxOccurs=l) element contains the actual value of the email address 
(e.g. someone@microsoft.com). The /myContacts/contact/emailAddress/name (string 
minOccurs=0 maxOccurs=l) element contains the friendly, or display name associated with 
J;a 10 this email address. The /myContacts/contact/emailAddress/name/@xml:lang (minOccurs=l 
tU maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3 166 

% ^ country code as described in RFC 1 766. The value of this attribute indicates the language type 

1 11 of the content within this element. The /myContacts/contact/emailAddress/name/@dir (string 

O minOccurs=0 maxOccurs= 1 ) optional attribute specifies the default layout direction for the 

ru 

l U 1 5 localized string. Valid values are rtl (right to left), and ltr (left to right). 

13 

:!» The /myContacts/contact/emailAddress/{any} (minOccurs=0 maxOccurs=unbounded) 

allows for extensibility with respect to email contacts. 

The /myContacts/contact/webSite (minOccurs=0 maxOccurs=unbounded) element 
encapsulates an electronic address for this entity, specifically, it contains a web site or URL 
20 associated with this identity. This element may be repeated any number of times. Typical use is 
one WebSite element for each web site associated with this identity. The 
/myContacts/contact/webSite/@changeNumber (minOccurs=0 maxOccurs=l) changeNumber 
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attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read-only to 
applications. Attempts to write this attribute are silently ignored. 

The/myContacts/contact/webSite/@id (minOccurs=0 maxOccurs=l) attribute is a 
globally unique ID assigned to this element by .NET My Services. Normally, .NET My 
Services will generate and assign this ID during an insertRequest operation, or possibly during 
a replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read-only 
and attempts to write it are silently ignored, 
b 10 The /myContacts/contact/webSite/@creator (string minOccurs=0 maxOccurs=l) 

m attribute identifies the creator in terms of userld, appld, and platformld of the node. 

H The /myContacts/contact/webSite/cat (minOccurs=0 maxOccurs=l) element is used to 

v — 

categorize the element that contains it by referencing a global category definition in either the 
b NET Categories (myCategories) service system document or an external resource containing 

ru 

5! 1 5 category definitions, or by referencing an identity centric category definition in the content 

O 

document of the .NET Categories service for a particular puid. The 
/myContacts/contact/webSite/cat/@ref (anyURI minOccurs=0 maxOccurs=l) attribute 
references a category definition (<catDef/>) element using the rules outlined in the 
myCategories section of the present application. 
20 The /myContacts/contact/webSite/url (string minOccurs= I maxOccurs= 1 ) element contains the 
URL for this web site. If the site is accessible through multiple URLs, this element may be 
repeated an appropriate number of times. 



1 ; = 
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The /myContacts/contact/webSite/{any} (minOccurs=0 maxOccurs=unbounded) 
provides extensibility. 

The /myContacts/contact/screenName (minOccurs=0 maxOccurs=unbounded) element 
encapsulates an electronic address for this entity, specifically, it contains a screen name 
5 commonly used in real time communications applications like instant messaging applications, 
chat rooms, and so on. This element may be repeated any number of times, and the type 
attribute may be used for simple classifications on the screenName. The 
/myContacts/contact/screenName/cat (minOccurs=0 maxOccurs=l) element is used to 
categorize the element that contains it by referencing a global category definition in either the 
10 .NET Categories service system document or an external resource containing category 

definitions, or by referencing an identity centric category definition in the content document of 
the NET Categories service for a particular puid. 

The /myContacts/contact/screenName/cat/@ref (anyURI minOccurs=0 maxOccurs=l) 
attribute references a category definition (<catDef/>) element using the rules outlined in the 
1 5 myCategories section of the present application. The /myContacts/contact/screenName/name 
(string minOccurs=l maxOccurs=l) element contains the value of the screen name. 
The /myContacts/contact/screenName/name/@xml:lang (minOccurs=l maxOccurs=l) 
This required attribute is used to specify an ISO 639 language code or an ISO 3166 country 
code as described in RFC 1766. The value of this attribute indicates the language type of the 
20 content within this element. The /myContacts/contact/screenName/name/@dir (string 

minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and Itr (left to right). 
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The /myContacts/contact/screenName/{any} (minOccurs=0 maxOccurs=unbounded) 
The /myContacts/contact/telephoneNumber (minOccurs=0 maxOccurs=unbounded) element 
encapsulates an electronic address for this entity, specifically, it contains a telephone number. 
This element may be repeated any number of times. Typical use is one telephoneNumber 
5 element for each phone number associated with this identity. A telephone number comprises 
an optional country code, a required nationalCode (e.g., US area code), a number, an optional 
extension, and an optional pin (described below). 

The /myContacts/contact/telephoneNumber/@changeNumber (minOccurs=0 
maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 

■s . 

Q 10 descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read-only to applications. Attempts to write this attribute are silently ignored. 
The /myContacts/contact/telephoneNumber/@id (minOccurs=0 maxOccurs-1 ) attribute is a 

* ' globally unique ID assigned to this element by .NET My Services. Normally, .NET My 

* . 

Q Services will generate and assign this ID during an insertRequest operation, or possibly during 

fU 

|U 15 a replaceRequest. Application software can override this ID generation by specifying the 

O 

- * useClientlds attribute in the request message. Once an ID is assigned, the attribute is read-only 

and attempts to write it are silently ignored. 

The /myContacts/contact/telephoneNumber/@creator (string minOccurs=0 
maxOccurs=l) attribute identifies the creator in terms of userld, appld, and platformld of the 
20 node. The /myContacts/contact/telephoneNumber/cat (minOccurs=0 maxOccurs=unbounded) 
element is used to categorize the element that contains it by referencing a global category 
definition in either the .NET Categories service system document or an external resource 
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containing category definitions, or by referencing an identity centric category definition in the 
content document of the .NET Categories service for a particular puid. The 
/myContacts/contact/telephoneNumber/cat/@ref (anyURI minOccurs=0 maxOccurs= 1 ) 
attribute references a category definition (<catDef/>) element using the rules outlined in the 
5 myCategories section of the present application. 

The /myContacts/contact/telephoneNumber/countryCode (string minOccurs=0 
maxOccurs=l) optional element specifies the country code for this telephone number. 
The /myContacts/contact/telephoneNumber/nationalCode (string minOccurs=l maxOccurs=l) 
element specifies the national code for this phone number. For US telephone numbers, this is 

C3 10 equivalent to the area code. The /myContacts/contact/telephoneNumber/number (string 

O 

f IJ minOccurs=l maxOccurs=l) element specifies the actual telephone number within the country 

id 

= 7 and national code number scheme. 

r J The/myContacts/contact/telephoneNumber/numberExtension (string minOccurs=0 

O maxOccurs=l) optional element specifies an extension used to reach this identity and this 

fU 

S 15 number. The /myContacts/contact/telephoneNumber/pin (string minOccurs=0 maxOccurs=l) 
optional element specifies a pin number used on this phone number. A pin is similar to an 
extension, but pin's are commonly used to address pagers while extensions are typically used 
to address phones relative to a local pbx. The /myContacts/contact/telephoneNumber/{any} 
(minOccurs=0 maxOccurs=unbounded) allows telephone number extensibility. 
20 The /myContacts/contact/identificationNumber (minOccurs=0 maxOccurs=unbounded) 

optional element encapsulates an identification number for the entity. For example, information 
such as an employee ID number, social security number, national ID number, drivers license 
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number, and so on, may be stored within this element. The 

/myContacts/contact/identificationNumber/cat (minOccurs=0 maxOccurs=l) element is used to 
categorize the element that contains it by referencing a global category definition in either the 
.NET Categories service system document or an external resource containing category 
5 definitions, or by referencing an identity centric category definition in the content document of 
the .NET Categories service for a particular puid. The 

/myContacts/contact/identificationNumber/cat/@ref (anyURI minOccurs=0 maxOccurs=l) 
attribute references a category definition (<catDef/>) element using the rules outlined in the 
myCategories section of the present application. The 
b 10 /myContacts/contact/identificationNumber/number (string minOccurs=l maxOccurs=l) 

f U element contains the actual identification number value. The 

I* 

/myContacts/contact/identificationNumber/{any} (minOccurs=0 maxOccurs=unbounded) 
I' " provides extensibility for identification number type of information. 

J:sa 

#3 The /myContacts/contact/worklnformation (minOccurs=0 maxOccurs=unbounded) 

!U 

15 element encapsulates work-related or occupation-related information for this entity. 

« 

** The /myContacts/contact/workInformation/@changeNumber (minOccurs=0 maxOccurs=l) 

changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to applications. Attempts to write this attribute are silently ignored. 
20 The /myContacts/contact/worklnformation/@id (minOccurs=0 maxOccurs=l) attribute 

is a globally unique ID assigned to this element by NET My Services. Normally, NET My 
Services will generate and assign this ID during an insertRequest operation, or possibly during 
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a replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read-only 
and attempts to write it are silently ignored. 

The /myContacts/contact/workInformation/@creator (string minOccurs=0 
i maxOccurs=l) attribute identifies the creator in terms of userld, appld, and platformld of the 
node. The /myContacts/contact/worklnformation/cat (minOccurs=0 maxOccurs=unbounded) 
element is used to categorize the element that contains it by referencing a global category 
definition in either the .NET Categories service system document or an external resource 
containing category definitions, or by referencing an identity centric category definition in the 
£3 10 content document of the .NET Categories service for a particular puid. 

The /myContacts/contact/workInformation/cat/@ref (anyURI minOccurs=0 
maxOccurs=l) attribute references a category definition (<catDef/>) element using the rules 
outlined in the myCategories section of the present application. The 
/myContacts/contact/worklnformation/profession (string minOccurs=0 maxOccurs=l) 
JH 15 This optional element specifies the entity's profession within this particular worklnfbrmation 
element. The/myContacts/contact/workInformation/profession/@xml:lang (minOccurs=l 
maxOccurs=l) is a required attribute used to specify an ISO 639 language code or an ISO 
3166 country code as described in RFC 1766. The value of this attribute indicates the 
language type of the content within this element. The 
20 /myContacts/contact/workInformation/profession/@dir (string minOccurs=0 maxOccurs=l) 
optional attribute specifies the default layout direction for the localized string. Valid values are 
rtl (right to left), and ltr (left to right). 



: : 
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The /myContacts/contact/worklnformation/jobTitle (string minOccurs=0 
maxOccurs=l) element specifies the job title for this piece of work information. The 
/myContacts/contact/workInformation/jobTitle/@xml:lang (minOccurs= 1 maxOccurs=l ) 
required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
5 described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myContacts/contact/workInformation/jobTitle/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and Itr (left to right). 

The /myContacts/contact/worklnformation/officeLocation (string minOccurs=0 
£3 10 maxOccurs=l) element specifies the office location for this piece of work information. 
f y The /myContacts/contact/workInformation/officeLocation/@xml:lang (minOccurs=l 

£ 3 

H maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3 166 

* ' country code as described in RFC 1 766. The value of this attribute indicates the language type 

H of the content within this element. The 

ffi 

Jjj 15 /myContacts/contact/workInformation/officeLocation/@dir (string minOccurs=0 
H maxOccurs=l ) optional attribute specifies the default layout direction for the localized string. 

Valid values are rtl (right to left), and ltr (left to right). 

The /myContacts/contact/worklnformation/coworkerOrDepartment (minOccurs=0 

maxOccurs=unbounded) element encapsulates information about this entity's manager, 
20 assistant, company, department, and so on. The information can include its name, its PUID and 
its email address. Using this anchor information, additional details may be obtained. The 
required cat element indicates the relationship of the element to this entity (e.g., ref=" 
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system#manager" ). The /myContacts/contact/worklnformation/coworkerOrDepartment/name 
(string minOccurs=0 maxOccurs=l) optional element specifies the name for the enclosing 
element. 

The /myContacts/contact/workInformation/coworkerOrDepartment/name/@xml : lang 
5 (minOccurs=l maxOccurs=l ) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 

the language type of the content within this element. The 
/myContacts/contact/workInformation/coworkerOrDepartment/name/@dir (string 

minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
10 localized string. Valid values are rtl (right to left), and ltr (left to right). 

The/myContacts/contact/worklnformation/coworkerOrDepartment/puid (string 

minOccurs=0 maxOccurs=l) optional element specifies the name for the enclosing element. 
The /myContacts/contact/worklnformation/coworkerOrDepartment/email (string minOccurs=0 
maxOccurs=l) optional name specifies an email address for the enclosing element. The 

1 5 /myContacts/contact/worklnformation/coworkerOrDepartment/cat (minOccurs= 1 

maxOccurs=l) element is used to categorize the element that contains it by referencing a 
global category definition in either the .NET Categories service system document or an 
external resource containing category definitions, or by referencing an identity centric category 
definition in the content document of the .NET Categories service for a particular puid. 

20 The /myContacts/contact/workInformation/coworkerOrDepartment/cat/@ref (anyURI 

minOccurs=0 maxOccurs=l) attribute references a category definition (<catDef7>) element 
using the rules outlined in the myCategories section of the present application. 
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The /myContacts/contact/workInformationy{any} (minOccurs=0 
maxOccurs=unbounded) extends the work information-related data. 

The /myContacts/contact/userReference (minOccurs=0 maxOccurs=unbounded) 
includes information related to reference data. The /myContacts/contact/userReference/name 
5 (string minOccurs=0 maxOccurs=l) optional element specifies the name for the enclosing 
element. The /myContacts/contact/userReference/name/@xml:lang (minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language type 
of the content within this element. The /myContacts/contact/userReference/name/@dir (string 
O 10 minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
| *f localized string. Valid values are rtl (right to left), and ltr (left to right). 

= _ 5 

The /myContacts/contact/userReference/puid (string minOccurs=0 maxOccurs=l ) 

m 

b optional element specifies the name for the enclosing element. The 

P /myContacts/contact/userReference/email (string minOccurs=0 maxOccurs=l) optional name 

!J( 15 specifies an email address for the enclosing element. The 

/myContacts/contact/userReference/cat (minOccurs=l maxOccurs=l) element is used to 
categorize the element that contains it by referencing a global category definition in either the 
.NET Categories service system document or an external resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
20 the .NET Categories service for a particular puid. The 

/myContacts/contact/userReference/cat/@ref (anyURl minOccurs=0 maxOccurs=l) attribute 
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references a category definition (<catDef/>) element using the rules outlined in the 
myCategories section of the present application. 

The /myContacts/contact/securityCertificate (minOccurs=0 maxOccurs=unbounded) is 
directed to securityCertificate data. The /myContacts/contact/securityCertificate/cat 
(minOccurs=0 maxOccurs=unbounded) element is used to categorize the element that contains 
it by referencing a global category definition in either the .NET Categories service system 
document or an external resource containing category definitions, or by referencing an identity 
centric category definition in the content document of the .NET Categories service for a 
particular puid. The /myContacts/contact/securityCertificate/cat/@ref (anyURI minOccurs=0 

maxOccurs=l) attribute references a category definition (<catDef/>) element using the rules 

outlined in the myCategories section of the present application. 

The /myContacts/contact/securityCertificate/certificate (hexBinary minOccurs=l 

maxOccurs=l) includes the certification information, and the /myContacts/contact/{any} 

(minOccurs=0 maxOccurs=unbounded) allows for extensibility. 

The myContacts content document include a subscription node that essentially takes 

action when items change, such as to propagate information about the change to other 

services. 

The /myContacts/subscription (minOccurs=0 maxOccurs=unbounded) element defines 
a subscription node that is designed to be an xdb:blue node which when placed in a content 
document causes a subscription to be registered, (wherein as used herein, the string 
"myContacts" referred to in this section can be replaced by an appropriate service name, e.g., 
"myApplicationSettings" or "myContacts" or "myWallet" and so forth). A subscription 
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contains a trigger element which selects a scope of coverage. When items that are under this 
scope of coverage change, a subscriptionResponse message is generated and sent to the 

specified destination address. 

The /myContacts/subscription/@changeNumber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system, and the attribute is 
read-only to applications; attempts to write this attribute are silently ignored. 
The /myContacts/subscription/@id (minOccurs=0 maxOccurs=l) attribute is a globally unique 
ID assigned to this element by .NET My Services. Normally, NET My Services will generate 
3 10 and assign this ID during an insertRequest operation, or possibly during a replaceRequest. 

Application software can override this ID generation by specifying the useClientlds attribute in 
the request message. Once an ID is assigned, the attribute is read-only and attempts to write it 
a are silently ignored. 

3 . 

f. 

13 The /myContacts/subscription/@creator (string minOccurs=0 niaxOccurs=l ) attribute 

!| 15 identifies the creator in terms of userld, appld, and platfbrmld of the node. The 
/myContacts/subscription/trigger (minOccurs=l maxOccurs=l) includes the 
/myContacts/subscription/trigger/@select (string minOccurs=0 maxOccurs=l) item, which 
specifies an XPATH expression that specifies the nodes that are to be selected and watched for 
changes. The selection may only select xdb.blue nodes, as described above. A s changes in 
20 this node set occur, they trigger the generation of a subscription message. These messages are 
then sent to the SOAP receiver listed in the "to" element. 
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The /myContacts/subscription/trigger/@mode (string minOccurs=0 maxOccurs=l) 

attribute specifies whether or not the content of the changes that triggered the subscription are 

delivered in the subscription message, or if the message simply indicates that something 

changed under the trigger. The attribute may comprise includeData, namely that the data that 

5 changed and caused the subscription to trigger is included in the subscription message. Note 

that deleted nodes are specified by their id, not by value. Alternatively the attribute may 

comprise excludeData, whereby the data that changed, causing the subscription to trigger, is 

not included in the subscription message. 

The/myContacts/subscription/trigger/@baseChangeNumber (minOccurs=0 

?= 

13 10 maxOccurs=l) attribute specifies the changeNumber value that the trigger is relative to. All 

C3 

ff changes between the specified change number, and the current state of the document relative 

U to the selection are transmitted as subscription messages. This allows a client application to 

411 

s establish a subscription relative to some baseline. As in changeQuery, if the 

|* 

; C3 baseChangeNumber is way out of date relative to the current state of the document, and the 

ru 

{U 15 service can not supply the changes in the subscription message, the subscription insert is 
" != rejected. A value of zero (0) means that the current values of the selected nodes are 

transmitted in the subscription message. 

The/myContacts/subscription/expiresAt (dateTime minOccurs=0 maxOccurs=l) 
optional element specifies an absolute time after which the subscription is no longer active. 
20 The subscription node is automatically removed when the subscription expires. If this element 
is missing, the subscription does not expire. The /myContacts/subscription/context 
(minOccurs=l maxOccurs=l) element returns the context element from the original 
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subscription. Applications should use this element to correlate the subscription response with 
one of their subscriptions. 

The/myContacts/subscription/context/@uri (anyURI minOccurs=0 maxOccurs=l) 
attribute specifies the URI value chosen by the subscriber that is associated with this 
subscription. The /myContacts/subscription/context/{any} (minOccurs=0 
maxOccurs=unbounded) including the /myContacts/subscription/to (anyURI minOccurs=l 
maxOccurs=l) attribute specifies the location that is to receive the subscription message. The 
value of this element may be hs: my Alerts, whereby this URI indicates that generated 
subscription messages are to be delivered inside the body of a notification and delivered to the 
default .NET Alerts service of the creator. Alternatively, the value may be protocol ://service, 
whereby this URI indicates that generated subscription messages are delivered to the specified 
service at the domain of the creator's platformld. For example, a platformld indicating 
microsoft.com, and a value in this element of http://subscriptionResponse would cause delivery 
of the subscription message to http://subscriptionResponse.microsoft.com. If this value is not 
specified, then the subscription message is delivered as a notification to the "creator's" .NET 
Alerts service. The /myContacts/{any} (minOccurs=0 maxOccurs=unbounded) field allows for 
extensibility. 

MxContacts / System 

The system document is a global document for each service, having content and 
meaning that is independent of the puid used to address the service. The document is read 
only to all users. Each system document contains a set of base items common to each of the 



-58- 



.NET My Services described herein, and is optionally extended by each service to include 

service-specific global information. The following schema outline illustrates the layout and 

meaning of the information found in the my Contacts system document: 

TABLE - factual service name*/ system 

<sys: system changeNumber =" ..." instanceld=" ..." 

xmlns:hs=" http://schemas.microsoft.com/lis/2001/10/core" 

xmlns:sys=" http://schemas.microsoft.com/lis/2001/10The factual service name*/system" > ul 
<hs:svstem Version changeNumber =" ..." id="..." creator=" ..." >i .1 

<hs:versionmajorVersion= 44 ..." minorVersion=" ..." buildNumber=" ..." qfe=" ..." >i..i 
<hs : productReleaseName> i .. i </hs : p roductReleaseName> 
<hs :productImplementationName> M </hs :productImplementatioiiName> 
</hs:version> 

<hs:buildDate>i..i</hs:buildDate> 

<hs:buildDetails machine= 44 ..." branch= 44 ..." type= 44 ..." official" ..." >,.. 1 </lis:buildDetails> 
</hs:systemVersion> 

<hs:roleMap changeNumber = 44 ..." id= 44 ..." creator= 44 ..." >u 

<hs:SCOpe id=" ..." >0..unbounded 

<hs:name xml:lang=" ..." dir=" ..." >o..unbounded</hs:name> 
<hs:shape base=" ..." >i..i 

<hs:include select=" ..." >o..unbounded</hs:include> 

<hs:exclude select=" ..." >o.unbounded</hs:exclude> 
</hs:shape> 
</hs:scope> 

<hs:roleTemplate name- 4 ..." priority-' 4 ..." >o. unbounded 

<hs:fullDescription xml:lang= 44 ..." dir= 44 ..." > 0 ..i</lis:fullDescription> 
<hs:method name=" ..." scopeRef= 44 ..." >o.. un boundcd < /hs:method> 
</hs:roleTemplate> 
</hs:roleMap> 

<hs:methodMap changeNumber = 44 ..." id= 44 ..." creator =" ..." >u 

<hs:method name=" ..." >o..unbounded /a/7>:/</hs:method> 
</hs:methodMap> 

<hs:schemaMao changeNumber =" ..." id- ' ..." creator= 44 ..." >u 

<hs:schema namespace= 4 ' ..." schemaLocation= 44 ..." alias= 4i ..." >o..unboundcd /a/f>^</hs:schema> 
</hs:schemaMap> 

<hs:wsdlMap changeNumber =" ..." id= 44 ..." creator= " ..." >u 

<hs:wsdl wsdlLocation= 44 ..." >o..unbounded /a«v/</hs:\vsdl> 

<hs:disco discoLocation= 44 ..." ^.unbounded /a//v/</hs:disco> 

<hs:vvsil \vsilLocation=" ..." >o..unbounded fanyj<lhs:\\sil> 
</hs:wsdlMap> 
</any> 

</sys:system> 
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The meaning of the attributes and elements shown in the preceding sample document 
outline follow, beginning with /system (minOccurs=l maxOccurs=l), the element that 
encapsulates a system document common to the various services. Although each service has 
its own system document, the common system document attributes and elements are described 
once, for purposes of simplicity, with service-specific system document attributes and elements 
specified for each service, below. The /system/@changeNumber (minOccurs=0 maxOccurs=l) 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read-only to 
applications. Attempts to write this attribute are silently ignored. 

The /system/@instanceld (string minOccurs=0 maxOccurs=l) attribute is a unique 
identifier typically assigned to the root element of a service. It is a read-only element and 
assigned by the .NET My Services system when a user is provisioned for a particular service. 

The /system/system Version (minOccurs=l maxOccurs=l) element defines version 
information describing this instance of the .NET MyServices service. The 
/system Version/@changeNumber (minOccurs=0 maxOccurs=l) changeNumber attribute is 
designed to facilitate caching of the element and its descendants. This attribute is assigned to 
this element by the .NET My Services system. The attribute is read-only to applications; 
attempts to write this attribute are silently ignored, (e.g., without generating an error). 

The /system/systemVersion/@id (minOccurs=0 maxOccurs=l ) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
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useClientlds attribute in the request message. Once an ID is assigned, the attribute is read-only 
and attempts to write it are silently ignored. 

The /system/systemVersion/@creator (string minOccurs=0 maxOccurs=l) attribute 
identifies the creator in terms of userld, appld, and platformld of the node. The 
/system/system Version/version (minOccurs=l maxOccurs=l) element defines major, minor, 
and build number version information. The /system/system Version/version/@majorVersion 
(string minOccurs=0 maxOccurs=l) attribute specifies the major version number of the .NET 
MyServices service. 

The /system/systemVersion/version/@minorVersion (string minOccurs=0 
maxOccurs=l) attribute specifies the minor version number of the .NET MyServices service. 
The /system/systemVersion/version/@buildNumber (string minOccurs=0 maxOccurs=l) 
attribute specifies the buildNumber of the .NET MyServices service. The 
/system/systemVersion/version/@qfe (string minOccurs=0 maxOccurs=l) attribute specifies 
the qfe version number of the .NET MyServices service. The 

/system/systemVersion/version/productReleaseName (string minOccurs=l maxOccurs=l) 
element defines the major product release string (as in .NET My Services Beta 1, and so on). 
The /system/systemVersion/version/productlmplementationName (anyURI minOccurs=l 
maxOccurs=l) element defines the class of the service to differentiate between different 
implementations. 

The /system/systemVersion/buildDate (dateTime minOccurs=l maxOccurs=l) element 
defines the date and time that the .NET My Services system was built. The time is in UTC (Z 
relative) form. The /system Version/buildDetails (minOccurs=l maxOccurs=l) element defines 
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details of the build including the machine that generated the build, the branch id of the software 
that contributed to the build, the type of build (chk/fre), and if the build was generated by an 
official build release process. 

The /system/system Version/buildDetails/@machine (string minOccurs=0 
5 maxOccurs=l) attribute specifies the machine that generated the build. The 

system/systemVersion/buildDetails/@branch (string minOccurs=0 maxOccurs=l) attribute 
specifies the software branch id for the source code that contributed to this build. The 
/system/systemVersion/buildDetails/@type (string minOccurs=0 maxOccurs=l) attribute 
specifies the type of build. A value of chk indicates that this is a checked or debug build. A 
f«3 10 value offre indicates that this is a retail build. The 

ru 

ll /system/systemVersion^uildDetails/@ofFlcial (string minOccurs=0 maxOccurs=l) attribute 

iy 

H indicates that the build was produced by an official build process (value of yes), or an unofficial 

Cn 

process (value of no). 

}^ The /system/roleMap (minOccurs=l maxOccurs=l) element encapsulates all the 

£3 15 elements that make up a roleMap, which include document class relative roleTemplate, 

jU 

priority, name, method, and per-method scope. An individual roleTemplate defines the 
maximum scope of information, and the allowable methods used to access that information for 
each request mapped into the template. The /system/roleMap/@changeNumber (minOccurs=0 
maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 
20 descendants. This attribute is assigned to this element by the NET My Services system. The 
attribute is read-only to applications. Attempts to write this attribute are silently ignored. The 
/system/roleMap/@id (minOccurs=0 maxOccurs=l) attribute is a globally unique ID assigned 
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to this element by .NET My Services. Normally, .NET My Services will generate and assign 
this ID during an insertRequest operation, or possibly during a replaceRequest. Application 
software can override this ID generation by specifying the useClientlds attribute in the request 
message. Once an ID is assigned, the attribute is read-only and attempts to write it are silently 
ignored. 

The /system/roleMap/@creator (string minOccurs=0 maxOccurs=l) attribute identifies 
the creator in terms of userld, appld, and platformld of the node. The /system/roleMap/scope 
(minOccurs=0 maxOccurs=unbounded) element defines a scope which may be referred to by 
roles within this roleMap to indicate what portions of the document are visible to this role for 
the specified method. 

The /system/roleMap/scope/@id (minOccurs=0 maxOccurs=l) attribute is a globally 
unique ID assigned to this element by NET My Services. Normally, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read-only 
and attempts to write it are silently ignored. The /system/roleMap/scope/name (string 
minOccurs=0 maxOccurs=unbounded) node includes the 

/system/roleMap/scope/name/@xml:lang (minOccurs=l maxOccurs=l) required attribute, 
which is used to specify an ISO 639 language code or an ISO 3 166 country code as described 
in RFC 1766. The value of this attribute indicates the language type of the content within this 
element. The /system/roleMap/scope/name/@dir (string minOccurs=0 maxOccurs=l) optional 
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attribute specifies the default layout direction for the localized string. Valid values are rtl (right 
to left), and ltr (left to right). 

The /system/roleMap/scope/shape (minOccurs=l maxOccurs=l) comprises a shape that 
defines the node set that is visible through the document when operating through this shape 
element. The /system/roleMap/scope/shape/@base (string minOccurs=0 maxOccurs=l) 
attribute specifies the initial set of nodes visible through the shape. A value of t indicates that 
the shape is initialized to include all possible nodes relative to the shape that is currently in 
effect. For instance, each role defines a scope containing a shape. When defining a shape for a 
role, the value t indicates all possible nodes available in the specified document for this role. 
When defining a shape in an ACL entry, a value of t means all of the nodes visible in the shape 
for the computed role. When using a shape in a data language (e.g., query, insert, replace and 
so on) operation, a value of t indicates all of the possible nodes selected by the data language 
operation (relative to the ACL shape which itself is relative to the role's shape). The value nil 
indicates the opposite oft, which is the empty node set. Nodes from this set may then be 
included into the shape. 

The /system/roleMap/scope/shape/include (minOccurs=0 maxOccurs=unbounded) 
element specifies the set of nodes that should be included into the shape relative to the possible 
set of nodes indicated by the base attribute. The /system/roleMap/scope/shape/include/@select 
(string minOccurs=0 maxOccurs=l) item specifies an XPATH expression that selects a set of 
nodes relative to the externally established context. The expression can never travel outside 
the node-set established by this externally established current context. The expression may 
match zero or more nodes, and the operation manipulates all selected nodes. The minOccurs 
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and maxOccurs attributes are optional and place restrictions and limitations on the number of 
nodes selected. 

The /system/roleMap/scope/shape/exclude (minOccurs=0 maxOccurs=unbounded) 
element specifies the set of nodes that should be excluded from the shape relative to the 
5 possible set of nodes indicated by the base attribute. The 

/system/roleMap/scope/shape/exclude/@select (string minOccurs=0 maxOccurs=l) item 
specifies an XPATH expression that selects a set of nodes relative to the externally established 
context. The expression can never travel outside the node-set established by this externally 
i A established current context. The expression may match zero (0) or more nodes, and the 

IJ 

q 10 operation manipulates all selected nodes. The minOccurs and maxOccurs attributes are 

fO 

M optional and place restrictions and limitations on the number of nodes selected. The 

W 
M 
111 



/system/roleMap/roleTemplate (minOccurs=0 maxOccurs=unbounded) element encapsulates 
the definition of a role. The attribute set for this element includes the document class that this 



S : 

ill roleTemplate refers to, the name of the roleTempIate, and the priority of the roleTemplate. 

fU 

O 15 The /system/roleMap/roleTemplate/@name (string minOccurs=0 maxOccurs=l) 



element specifies the name of the role. The /system/roleMap/roleTemplate/@priority (int 
minOccurs=0 maxOccurs=l) element specifies the priority of the roleTemplate which is used 
to select that actual roleTemplate when the role evaluation determines that the subject maps to 
multiple roleTemplates. 
20 The /system/roleMap/roleTemplate/flillDescription (string minOccurs=0 

maxOccurs=l) element contains a description of this role template which specifies the 
capabilities a caller will have when accessing information through this role. The 
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/system/roleMap/roleTemplate/flillDescription/@xml:lang (minOccurs=l maxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /system/roleMap/roleTemplate/fullDescription/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and ltr (left to right). 

The /system/roleMap/roleTemplate/method (minOccurs=0 maxOccurs=unbounded) 
element specifies the methods available within this roleTemplate by name, and by scope. When 
a subject maps to a roleTemplate, the method in the request must match one of these elements 
for the message to continue to flow. If the method exists, the data available to the method is a 
function of the scope referenced by this method combined with an optional scope referenced 
by the role defined in the roleList. 

The /system/roleMap/roleTemplate/method/@name (string minOccurs=0 
maxOccurs=l) element specifies the name of the method. The 

/system/roleMap/roleTemplate/method/@scopeRef (string minOccurs=0 maxOccurs=l) 
attribute specifies the scope within this document that is in effect for this method. The 
/system/methodMap (minOccurs=l maxOccurs=l) element defines the methodMap. While in 
most cases, the roleMap section contains a definitive list of methods, these methods are likely 
to be scattered about the roleMap in various templates. This section contains the definitive 
non-duplicated list of methods available within the service. 

The /system/methodMap/@changeNumber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
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This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to applications. Attempts to write this attribute are silently ignored. 

The /system/methodMap/@id (minOccurs=0 maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
5 generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read-only 
and attempts to write it are silently ignored. The /system/methodMap/@creator (string 

i A minOccurs=0 maxOccurs=l) attribute identifies the creator in terms of userld, appld, and 

13 10 platformld of the node. 
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The /system/methodMap/method (minOccurs=0 maxOccurs=unbounded) element 
defines a method that is available within this service. The /system/methodMap/method/@name 
(string minOccurs=0 maxOccurs=l) attribute specifies the name of a method available within 
JU the service. The /system/methodMap/method/ {any} (minOccurs=0 maxOccurs=unbounded) 

ru 

(5 15 provides for extensibility. The /system/schemaMap (minOccurs=l maxOccurs^l) element 

defines the various schema's that define the data structures and shape of information managed 
by this service. Each schema is defined by its namespace URI, its location, and a preferred 
namespace alias. 

The /system/schemaMap/@changeNumber (minOccurs=0 maxOccurs=l) 
20 changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to applications. Attempts to write this attribute are silently ignored. 
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The /system/schemaMap/@id (minOccurs=0 maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
5 useClientlds attribute in the request message. Once an ID is assigned, the attribute is read-only 
and attempts to write it are silently ignored. 

The /system/schemaMap/@creator (string minOccurs=0 maxOccurs=l) attribute 
identifies the creator in terms of userld, appld, and platformld of the node. The 
u /system/schemaMap/schema (minOccurs=0 maxOccurs=unbounded) element defines a schema 

b 

i : 3 10 which defines data-structures and the shape of information managed by this service. Multiple 

TU 

schema elements exist for each service, once for each logical grouping of information exposed 

W 

f Jj by the service. The /system/schemaMap/schema/@namespace (anyURI minOccurs=0 

l A maxOccurs=l) attribute specifies the namespace URI of this schema. The 

b 

fli /system/schemaMap/schema/@schemaLocation (anyURI minOccurs=0 maxOccurs-1) 

ru 

f 3 1 5 attribute specifies the location (in the form of a URI) of the resource containing schema. 

When a schema is reachable through a variety of URIs, one schema element will exist for each 
location. 

The/system/schemaMap/schema/@alias (string minOccurs=0 maxOccurs=l) attribute 
specifies the preferred alias that should be used if possible when manipulating information 
20 covered by this schema in the context of this service. The /system/schemaMap/schema/{any} 
(minOccurs=0 maxOccurs=unbounded) provides for extensibility. The /system/wsdlMap 
(minOccurs=l maxOccurs=l) element defines the wsdlMap for this service. This map includes 



-68- 



£3 

b 
ru 

iu 

In 



the location of WSDL documents, DISCO documents, and WSIL documents for this web 
service. These documents are used by applications to understand the format of messages that 
may be sent to the various services. The /system/wsdlMap/@changeNumber (minOccurs=0 
maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 

5 descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read-only to applications. Attempts to write this attribute are silently ignored. 

The /system/wsdlMap/@id (minOccurs=0 maxOccurs=l) attribute is a globally unique 
ID assigned to this element by .NET My Services. Normally, .NET My Services will generate 
and assign this ID during an insertRequest operation, or possibly during a replaceRequest. 

10 Application software can override this ID generation by specifying the useClientlds attribute in 
the request message. Once an ID is assigned, the attribute is read-only and attempts to write it 
are silently ignored. The /system/wsdlMap/@creator (string minOccurs=0 maxOccurs=l) 
attribute identifies the creator in terms of userld, appld, and platformld of the node. 



fjj The /system/wsdlMap/wsdl (minOccurs=0 maxOccurs=unbounded) element is used to 

fU 

O 15 specify the location of a WSDL file for this service. Multiple entries may exist pointing to the 



same file hosted in multiple locations, or to variations on the content within the WSDL files. 

The /system/wsdlMap/wsdl/@wsdILocation (anyURI minOccurs=0 maxOccurs=l) 
attribute is a URI that specifies the location of the WSDL file. The 
/system/wsdlMap/wsdl/{any} (minOccurs=0 maxOccurs=unbounded) provides for 
20 extensibility. 

The /system/wsdlMap/disco (minOccurs=0 maxOccurs=unbounded) element is used to 
specify the location of a DISCO (web-services discovery) file for this service. Multiple entries 
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may exist pointing to the same file hosted in multiple locations, or to variations on the content 
within the DISCO files. The /system/wsdlMap/disco/@discoLocation (anyURI minOccurs=0 
maxOccurs=l) attribute is a URI that specifies the location of the DISCO file. The 
/system/wsdlMap/disco/{any} (minOccurs=0 maxOccurs=unbounded) provides extensibility. 
The /system/wsdlMap/wsil (minOccurs=0 maxOccurs=unbounded) element is used to specify 
the location of a WSIL file for this service. Multiple entries may exist pointing to the same file 
hosted in multiple locations, or to variations on the content within the WSIL files. The 
/system/wsdlMap/wsil/@wsilLocation (any URI minOccurs=0 maxOccurs=l) attribute is a URI 
that specifies the location of the WSIL file. The /system/wsdlMap/wsil/{any} (minOccurs=0 
maxOccurs=unbounded) provides extensibility. 

myContacts Methods 

The myContacts service supports the standard methods query, insert, replace, delete, 
and update. 

As can be seen from the foregoing detailed description, there is provided a schema- 
based contacts service that allows users to access their data based on their identities and 
corresponding roles with respect to the data. The schema-based contacts service provides 
contacts data access independent of the application program and device, and in a centrally- 
accessible location such as the Internet. The schema-based contacts service is extensible to 
handle extended contact information. 
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While the invention is susceptible to various modifications and alternative 
constructions, certain illustrated embodiments thereof are shown in the drawings and have 
been described above in detail. It should be understood, however, that there is no intention to 
limit the invention to the specific forms disclosed, but on the contrary, the intention is to cover 
all modifications, alternative constructions, and equivalents falling within the spirit and scope 
of the invention. 
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